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PARCLS PROGRAM 


1.0 SCOPE 

This document contains the description of the implementation of the PARCLS 

program. The purposes of the program are as follows: 

(1) Read a parameter file created by the CLASFYG program and a pure pixel 
Ground Truth file to create a classification file of three separate 
crop categories in Universal Format. 

(2) Produce a report containing statistical information concerning the 
input Ground Truth file, training field chosen from the Ground Truth 
file, and output classification file. 
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2.0 APPLICABLE DOCUMENTS 


The following documents form a part of this specification: 

AD 63-2457-3308-03 Transferring Badhwar Software. 

AD NAS 9-15200 Technical Memorandum Format Specifications for LACIE (Phase 
III) and Accuracy Assessment Computer Data Products. 
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3.0 SYSTEM DESCRIPTION 


3.1 SYSTEM FLOWCHART , 

The system level data flow diagram for the PARCLS Program is depicted in 
Figure 3.1.1. A program hierarchy is shown in Figure 3.1.2. 


3-1 




Figure 3.1.1 System level flow diagram for the PARCLS Program. 



PARCLS 


PCLSIN 


PARLD. . . 


...CPTIME 

...JULIAN 


...CROPP 


ICE 

IVALUE 


DISCRM...MTMV 

OISCLS...ICE 


Figure 3.1.2 Hierarchy diagram for the PARCLS Program. 


3-3 


3.2 HARDWARE DESCRIPTION 


The software for the PARHIS Program Is operational on the IBM 3031 computer 
at PURDUE. 

3.3 SOR-WARE DESCRIPTION 

This program reads a parameter file created by the CLASFYG program and a 
Ground Truth file to create a classification file of three separate crop 
categorleV In UniversaT’FomatT The user defines the crop categories. 
Including a category to contain all selected pixels which lie outside a user 
defined tg range. (See section 3.4.2 for a complete description of the CROP, 
CATEGORY, and T0MINMAX cards.) 

The ground truth file Is first scanned to determine the number of pixels In 

each crop category. Depending on the training data size, a skip factor Is 

determined so as to sample the training pixels from the entire sepient. 

(See section 3.4.2 for a complete description of the Dots card.) The 

2 

parameter file provides the values of a, 6, t^, and x for these training 

pixels. Any coefficient within the parameter file greater than a user 
2 

defined x value determines that the pixel vector is of no interest and the 
pixel is not used for training. (See Section 3.4.2 for a 
description of the CHICUT card.) Using this data the separation plane is 
determined by the Ho- Kashyap linear classifier. This procedure maximizes 
the distance In the a, B, and tg space using the training data. Each pixel 
is assigned a symbol from one of the three crop categor'<es depending on 
where the pixel falls with respect to the separation plane. (See section 
3.4.2 for a complete description of the SYMBOL card.) 
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3.4 FILE DESCRIPTIONS 


3.4.1 INPUT FILE(S) 

Two Input data files are required to execute the PARCLS program. The two 
files and their description are as follows: 

PARCLS accepts as Input, a classification file output from the CLASFY6 

PROGRAM. This classification file consist of 118 records. The first 

record Is a header record consisting of 3060 bytes. The header record 

follows universal format requirements. Records 2-118 contain data records. 

Each data record consists of 196 pixel vectors. Each pixel vector consists 

2 

of four coefficients: a, g, t^ and x • E«ch coefficient contains a 
signed Integer value stored In a 32 - bit full word. (For a complete 
description of this file see "AS-BUILT'' DESIGN SPECIFICATION FOR CLASFYG 

LEMSCO-1 6649/ JSC-1 7369). 


The Ground Truth file Is in IfilVERSAL FORMAT with one channel per physical 
record. There are 351 records of length 540 8 bit-bytes. The contents . 
of each byte have been biased with -128 and are stored In 8 bit twos- 
complement notation. (For a complete description of the file see Earth 
Resources Data Format Control Book, Volume 1, PH0-TR543) . 
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3.4.2 USER DEFINED FILE (SYMBOL FILENAME) (SYMBOL FH^TYPE) A 

This file is used to specify (1) the pixel purity range and (2) the ground 
truth info’.mation. 

Corresponding to one classification pixel is six ground truth subpixels. 

A majority pixel is chosen from the six subpixels. This is either the 
category of the first subpixel or is the category which occurs the most 
among the subpixels. The number of occurances of the majority category is 
defined to be the purity of the given pixel. The pixel purity range defines 
the acceptable pixel purity for any given execution of the PARCLS PROGRAM. 
The ground truth transformation allows the user to map specific ground 
truth codes to “Classification Categories". These categories correspond 
to the numerical order of the categories entered on the CROP control card 
in the required control card file (See Section 3.4. 3*for all exceptions 
concerning the use of this card). Therefore, any assignment of a crop code 
to a category greater than the total nuirt>er of categories entered signifies 
that the code is of no interest. If a crop code is not assigned to a 
category the program assigns as a default a category of 6. The last entry 
in the symbol file must be 0 0 0. 

The first entry in the symbol file is as follows: 


Column 

1 

2 

3 


Format 

11 

IX 

11 ; 

Purpose 


start 


end : 

Defines the start and end of a 
range of pixel purity. 


The remaining entries in the symbol file are as follows: 
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Columns 


1-5 


6-10 


1-15 


Format 

15 

15 

15 

Purpose 


start 

end 

category : 

Defines the start and end of 
a range of crop values assigned 
to a category. 


0 

0 

0 

Signifies the end of Ground 


Truth transformation informa 
tion. 


The following is an example of a symbol file. 
1 6 

1 10 1 

11 20 2 

21 79 3 

80 80 6 

84 86 2 

127 127 3 

164 164 6 

165 165 3 

0 0 0 



3.4.3 USER DEFINED FILE (FILENAME) CC A 

This Control Card file is used to specify inputs to the PARPLT program. 

The inputs are on card image records. A record consists of (1) a keyword 
which is ten characters or less and begins in the first card column and 
(2) input parameters in coluitms 11 through 72. The following description 
lists the keywords and describes the correspondi ng inputs. 



KEYWORD 


ACCEPTABLE INPUTS 


DESCRIPTION 


T0MINMAX Pair of postive numbers This card defines the minimum 

and maximum acceptable t^ values. 

The numbers are assumed to be postive 
real numbers and any integers will 
be converted. The numbers are 
separated by any delimiter except 

I I 

DOTS 1^ number ^100 This card specifies the numbers of 

pixels within the training field. 

CATEGORY U number <3 This card defines the crop category 

which will contain all crops not 
classified as the primary or 
secondary crop. The number refers 
to order of crop names and, therefore, 
must not exceed the total number of 
crop names input. 

CROP 1-3 crop names This card gives name(s) to the 

categories to be plotted. The 
categories are separated by any 
non character deliminter except a 
blank. Embedded blanks are 
considered part of a category's name. 

CHICUT Postive number This card defines the upper limit 

2 2 
for all X values. If the x value 

is greater than this defined limit 

then the corresponding a value is 

set to zero. 
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KEYWORD 


ACCEPTABLE INPUTS 


DESCRIPTION 


SYMBOL 


AI 


SEGMENT 


♦END 


An example 
AI 

SEGMENT 

DATE 

DOTS 

CATEGORY 
CHI CUT 
TOMINMAX 
CROP 
♦END 


1 £ number ^ 255 


Analyst's name 


Segment number 


Ignored 


This card defines numeric symbols 
for each of the defined crop 
categories. These symbols are 
designated by crop codes produced 
by the data management section at 
J.S.C. and vary according to crop 
and year. 

This card specifies the analyst's 
name for report identification 
and is an optional input. 

This card specifies the segment 
number for report identification 
and is an optional input. 

This card identifies the end of 
the user defined cards. 


of a control card file is as follows: 

MARY ANN TOMPKINS 
0123 

MAY 26, 1981 

30 

3 

9999 

1100,1700 

CORN, SOYBEAN, OTHERS 
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3.5.1 PROGRAM PARCLS 


Purpose 

PARCLS calls the subroutines which compute from ground tr uth a 

training set and develops a Universal Classification file from a CLASFYG 
output parameter file. 

Linka^s 

PARCLS calls Subroutines PCLilN, PARLD, DISCRM and DISCLS. 

Interface 
Calling sequence: 

Not applicable (PARCLS EXEC which can be used to load and execute 
PARPLT is described in Section 4.0). 

Calling sequence parameters: 

None. 


Function value: 

Not applicable. 


Labeled COMMON parameters: 

Full description of labeled COf^ON 

Element 

Label Variable Position 

HEAD RCR0P(4,3) 1 

NCROP 2 

Blank COMMON parameters: 

None. 


blocks are contained in Appendix A. 
Input/ 

Output Description 

I Crop names . 

I Number of crop 

categories. 
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Inputs 

None. 


Outputs 

Uni t Type Description 

6 Printer Program report. 

Storage requirement 
Not applicable. 

Description 

PARCLAS calls the following routines for the given purpose: 

EQUHHE 
PCLSIN 
PARLD 
DISCRM 
DISCLS 

FI owchart 
Not applicable. 

Listi ng 

See Appendix B for routine listing. 


EUfiEQSE 
User inputs 

Chooses a. training field for each crop 

Linear descriminate matrix function 

Creates a one channel universal classification file 


3.5.2 SUBROUTINE CROPP 


Purpose 

CROPP accepts six subpixels as input and outputs a pixel value representative 
of the subpixels. 

Li nkages 

CROPP is called by PARPLT. 

Interface 

Calling sequence; 

CALL CROPP (KROP, IXLCNT). 

Calling sequence parameters: 

Input/ 

Argument Output Description 

KROP 0 Majority crop code. 

IXLCNT 0 Count of number subpixels that match the 

majority code. 

Function value: 

Not applicable. 

Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 




Element 

Input/ 


Label 

Variable 

Position 

Output 

Description 

/NSBIXL/ 

NSUBPX(6) 

1 

I 

Subpixels that map to 
a pixel . 


Blank C0^010N parameters: 
None. 
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Inputs 

None. 


Outputs 

None. 

Storage requirement 
Not applicable. 

Description 

The first sub-pixel value upon entry is considered to be the majority pixel 
(KROP) value. The NSUBPX array is traversed and tne number of codes equal 
to KROP counted. This procedure continues until a count of each unique 
code is made. If at anytime a count becomes greater than the count of 
KROP this code becomes KROP's value. 

Flowchart 
Not applicable. 


Listing 

See Appendix B for routine listing. 


3.5.3 SUBROUTINE OISCLS 


Purpose 

Produces*a «ne channel universal classification file from a CLASFY6 parameter 
file. 


Li nkaqes 

OISCLS is called by PARCLS. 


Interface 
Calling sequence: 

CALL OISCLS (W, KHICUT, MINMAX, KATGRY, ICOOE). 


Calling sequence parameters: 

Input/ 

Argument Output Description 


W I 

KHICUT I 

MINMAX I 

KATGRY I 

ICOOE I 


Weight matrix 
2 

X limit. 

Minimum and maximum values for t . 

0 

Category for parameters which lie outside the 
defined limits. 

Number symbols (crop codes). 


Function value: 

Not applicable. 


Labeled COMMON parameters: 
None. 


Blank COMMON parameters: 
None. 


3-15 


Inputs 

Unit 

Type 

Description 

10 

Sequential data 

Classification file (See Section 3.4.1). 

Outputs 

Unit 

Type 

Descrl ption 

6 

Printer 

Program report. 

28 

Sequential data 

Universal format classification file. 


storage requirement 
Not applicable. 

Dei^crlption 

OISCLS classifies the pixels on the basis of the parameters Alpha, Beta and 
t^ using a linear discriminate calculated In the SUBROUTINE DISCRM, and 
writes a one channel universal formatted file. 

Flowchart 
Not applicable. 

Listing 


See Appendix B for routine listing. 


3.5.4 SUBROUTINE DISCRM 


Purpose 

DISCRM calculates the weights to be used In a 3 class linear discriminate. 
Linkages 

DISCRM Is called by PARCLS. 

DISCRM calls MTNV. 


I nterface 

Calling sequence; 

CALL DISCRM (Nl, A, W) 


Calling sequence parameters; 

Input/ 

Argument Output Description 


Nl 

A 

W 


I Number of pixels sample per crop. 

I Training field. 

0 Weight matrix. 


Function value; 

Not applicable. 


Labeled COMMON parameters; 
None. 


Blank COMMON parameters; 
None. 


Inputs 

None 
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Outputs 

Unit Type Description 

. 5 Printer Program report. 

Storage requirement 
Not applicable. 

Description 

This program uses the Ho-Kashyap linear discriminate method. It solves 
the vector equation AW«B where A Is the data matrix; W is the wefght 
vector. 

FI owchart 
Not applicable. 

Listing 

See Appendix B for routine listing. 
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3.5.5 FUNCTION ICE 


Purpose 

To established the integer character equivalence of a byte. 
Linkages 

ICE is called by PPLTIN. 

Interface 

Calling sequence: 

K - ICE CINT). 

Calling sequence parameters: 

Input/ 

Argument Output 

INT I 

Function value: 

Name Description 

K One byte in computation form. 

Labeled COMMON parameters: 

None. 

Blank COMMON parameters: 

None. 

Inputs 
None. 

Outputs 
None. 


Description 

One byte in character form. 
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L 


storage requirement 
Not applicable. 


Description 

ICE sets the input parameter to the function and returns. 

Flowchart 
Not applicable. 

Listing 

See Appendix B for function listing. 
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3.5.6 FUNCTION IVALUE 


Purpose 

To allow the In line storage and testing of Integer quoted literals. 
LI nkaqes 

IVALUE Is called b> PPLTIN. 

Interface 

Calling sequence: 

K = IVALUE (INT). 

Calling sequence parameters: 

Input/ 

Argument Output Description 

INT I Q’loted literal declared Integer. 


Function value: 

Name Descri ption 

K Quoted literal. 

Labeled COMMON parameters: 

None. 

Blank COMMON parameters: 

None. 

Inputs 

None. 

Outputs 

None. 
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storage requirement 
Not applicable. 

Description 

IVALUE sets quoted literals to Integer function and returns. 

Flowchart 
Not applicable. 

Listing 

See Appendix B for function listing. 


3.5.7 SUBROUTINE JULIAN 


Purpose 

To convert a Gregorian Calendar date to a Julian calendar date. 
Linkages 

JULIAN is called by PARPLT. 

Interface 
Calling sequence: 

CALL JULIAN (JDATE, INERR, INDAY, INWTH, INYEAR). 

Calling sequence parameters: 

Input/ 

Argument Output 

J0ATE(3) 0 

INERR 0 

INDAY I 

INMNTH I 

INYEAR I 

Function value: 

Not applicable. 

Labeled COMMON parameters; 

None. 

Blank COMMON parameters; 

None. 

Inputs 
None. 


Description 

Array to return Julian date. 

Error flag Indicating Input value out of 
range (zero returned If no error occurred). 

Day of month. 

Month of the year. 

Last two digits of the year. 
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Outputs 

None. 


Storage requirement 
Not applicable. 

Description 

If the input day is less than 1 or greater than 31, and input month is 
less than 1 or greater than 12 set INERR = 1 for error flag and return. 
Compute Julian date from month and day. If the year -"s a leap year and 
the month is greater than two add one to the computed Julian date. 

Flowchart 
Not applicable. 


Listing 

See Appendix B for routine listing. 


3.5.8 SUBROUTINE WTNV 


Purpose 

MTNV computes the inverse of a NXN array. 
Linkages 

MTNV is called by DISCRM. 

Interface 
Calling sequence: 

CALL MTNV (AA, N, AINV) 

Calling sequence parameters: 

Input/ 

Argument Output 

AA I 

N I 

AINV 0 

Function value: 

Not applicable. 

Labeled COMMON parameters: 

None. 

Blank COMMON parameters: 

None. 

Inputs 
None. 

Outputs 
None. 


Description 

Input array. 

Array is NXN 

Inverse of AA (Input array) 
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storage requirement 
Not applicable. 

Description 

Computes the inverse of AA using an adaptation of the Gauss-Jordan algorithm. 

FI owchart 
Not applicable. 

Listing 

See Appendix B for routine listing. 
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3.5.9 SUBROUTINE PARLD 


Purpose 

PARLD develops a training set from a ground truth file. 
Linkages 

PARALO is called by PARCLS. 

PARALD calls subroutine JULIAN and CROPP. 


Interface 
Calling sequence: 

CALL PARLD (A, Nl, KHICUT, MINMAX, NUMDOT, lERR). 


Calling sequence parameters: 


Input/ 

Argument Output 

A 0 

Nl 0 

KHICUT I 

MINMAX I 

NUMDOT I 

lERR 0 


Function value: 

Not applicable. 


Description 

Training field array. 

Number of pixels sampled per crop. 

2 

Upper limit for acceptable x parameters. 
Minimum and maximum ranges for t^. 

Number of dots in a training set. 

Error flag. 

0 - OK 

1 - Error 


Labeled COMMON parameters: 

Full description of labeled COMMON blocks are contained in Appendix A. 




Element 

Input/ 


Label 

Variable 

Position 

Output 

Description 

NSBIXL 

NSBIXL 

1 

I 

Subpixel that map to 
a pixel . 

DEFGT 

GTRSEG 

1 

0 

Ground truth segment 
number. 
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Element Input/ 


Label 

Variable 

Position Ouput 

Description 


TYR 

2 

0 

Ground truth file year 


GTDATE(3) 

3 

0 

Ground truth file 
Julian date. 

DEFKL 

KLSE6 

1 

0 

Classification se^nt 
number. 


KYR 

2 

0 

Classification file 
year. 


KLDATE(3) 

3 

0 

Classification file 
Julian date. 

HEAD 

RCR0P(4,3) 

1 

I 

Crop names. 


NCROP 

2 

I 

Number of crops. 

Blank COMMON parameters: 


1 


None. 





Inputs 





Unit 

Type 


Description 


9 

Sequential data 


Ground truth file 

(See Section 3.4.1). 

10 

Sequential data 


Classification file (See Section 3.4.1). 

19 

Sequential data 


Symbolic mapping elements, pixel purity 
range. (See Section 3.4.2). 

Outputs 





Unit 

Jm. 


Description 


5 

Terminal 


Run time diagnostics 

6 

P» Inter 


Program report. 


Storage requirement 
Not applicable. 
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Description 


2 

The ground truth ^ta Is scanned to determine the numb er of each crop and each x 
coeWcl^t from t he p arameter flleTs c hecked to see that It I s less than a 

user defined limit. The Alpha parameter Is set to zero for those vectors 

2 

falling the x limit requirement. The parameter vectors are stored In the 
6UF array and are written to files. Each file contains vectors which relate 
to oiie crop as defined by the ground truth file. After processing all pixels 
a skip factor Is determined so as to sample the training pixels from the 
entire segment. The files previously written are then processed. Each pixel 
that Is a modular function of the skip factor Is tested against a user 
defined t^ range. If the pixel Is acceptable It becomes a part of the 
training field. 

Flowchart 
Not applicable. 

Listing 

See Appendix B for routine listing. 
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3.5.10 SUBROUTINE PCLSIN 
Purpose 


PCLSIN reads records tn card Image format, decodes the records, and test 
that the records contain appropriate Inputs and all necessary Information. 

Linkages 

PCLSIN Is called by PARCLS. 

PCLSIN calls Subroutine ICE and I VALUE. 

Interface 
Calling sequence: 

CALL PCLSIN (NCROP. RCROP. MINMAX. KAT6RY. NUMDOT. KHICUT. ISYM. lERR). 

Calling sequence parameters: 

I nput/ 


Argument 

Output 

Descrl ption 

NCROP 

0 

Number of crops to be evaluated. 

RCROP 

0 

Crop category names. 

MINMAX 

0 

Minimum maximum values for parameter. 

KATGRY 

0 

Category for all parameters other than the 
defined primary or secondary. 

NUMDOT 

0 

Number of dots In the training field. 

KHICUT 

0 

Define the upper limit for acceptable 
parameters. 

ISYM 

0 

Numeric symbols to represent crop categories. 

lERR 

0 

Error flag 

0 - OK 

1 - Error 


Function value: 

Not applicable. 


3-30 



Labeled COMMON parameters: 
None. 


Blank COMMON parameters: 
None. 


Inputs 

Unit Type Description 

21 Sequential data User information file (See Section 

3.4.3). 


Outputs 

Unit Type 

5 Terminal 

20 Pri nter 


Description 

Run time diagnostics. 

Report of user information file. 


Storage requirement 
Not applicable. 


Description 

PCLSIN processes each input card. After the *END card is reached PCLSIN 
test for the following conditions; 

1. More/less than two nuniers on the t^ MINMAX card. 

2. Minimum value > maximum value on the MINMAX card. 

3. The MINMAX, DOTS, CATEGORY, SYf«0L, CROP, or CHICUT card missing. 

4. More than three crops on a crop card. 

5. More than one number on the DOTS, CATEGORY, or CHICUT card. 

6. Number of symbols not equal to number of crops. 

If any of the conditions exist, a diagnostic message is issued and lERR is 
set to one. If a control card is not recognized, a warning message is 
printed. 
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Flowchart 
Not applicable. 


Listing 

See Appendix B for routine listing. 
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4.0 OPERATION 


4.1 OPERATING DESCRIPTION 

PAROLS Is operational on the IBM 3031 computer at LARS, West Lafayette, 
Indiana. 

The PAROLS program Is one of the programs of the BADHWAR SYSTEM which 
Includes the programs OLASFYT, OLASFYG, MISM/'P, PAROLS, PARHIS, and UNIV4VE0. 

PAROLS requires the use of a D disk which is assigned as a temporary disk 
and an E disk which is used by the LARS' routines. The user, therefore, 
must not assign a disk to his machine using either MODE E or MODE D. These 
disks, will be assigned as needed. 

Prior to executing the PAROLS program the user must (1) establish on his A 
disk a SYMBOL file as described in section 3.4.2 and (2) establish the OARD 
OONTROL file as described in section 3.4.3, if he wishes to use this file. 

4.2 COfiMANDS DESORIPTION 

To execute PAROLS, the user enters a series of commands which invoke the 
JOB OONTROL SOFTWARE. These commands are divided into two classes namely 
(1) FUNOTION commands and (2) PROGRAM commands. The FUNCTION conmands, 
which perform all the functions except executing the program are reusable; 
1 . 6 . , once they are invoked they remain in effect until reentered. The 
PROGRAM coimiands, which execute the program, must be reentered each time the 
program is to be executed. 

The following list gives the commands required to execute the PAROLS 
program. They are all FUNCTION commands except the PROGRAM command PAROLS. 
These commands must be given in the listed order except that the order of 
the DEFGTRU command and the DEFCLAS command may be interchanged. 
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START 


DErGTRU 

DEFCLAS 

PARCLS 

END 

The following sections describe each of the cotnmands in detail. Input fields 
are separated by blanks. If more than one work is required to describe an 
input field, the descriptive text is enclosed in pointed brackets <>. If an 
input is optional the field is enclosed in square brackets []. Do not 
include these explanatory characters <> [] when actually submitting input to 
the computer. To enter a command the user types one input per defined input 
field and separates each field with a blank. 


4-2 


4.2.1 START 


The START conmand spools the user's console ^ile. The user of this command, 
along with the END command, will provide listing of all information appear- 
ing on the user's console file. (If running an interactive job, this is 
the terminal. If running a batch job, this is a system defined device.) 

The START command is invoked by the user typing the following: 

START 
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4.2.2 DEFGTRU 

The DEFGTRU command defines a Ground Truth file. The user can use this 
command to define Ground Truth files on tape, disk, or may request the use 
of a file from the LARS RT&E Data Base. If the data request is for the use 
of a file from the LARS Data Base, a series of programs are invoked to 
provide interface with the data base. The following diagram illustrates 
this software flow. 


..RTEERR (LARS ROUTINE) 

DEFGTRU GTRUINF.... 

..GTINFO (LARS ROUTINE) 

For a detailed description of the above JOB CONTROL SOFTWARE see appendix B. 

The DEFGTRU command has the following forms and is invoked by typing one of 
the following, according to the user's requirement. 

If the file is on tape - 

DEFGTRU TAPE# FILE# <TAPE DENSITY> 

If the file is on disk - 

DEFGTRU FILENAME FILETYPE FILEMODE 
If the file is on the LARS Data Base - 

DEFGTRU SEGMENT# YEAR 

(year-last two digits of data generation year) 

This command remains in effect for the use of any of the BADHWAR SYSTEM 
PROGRAM commands and doss not have to be reissued unless the user wishes 
to redefine the input Ground Truth File. 
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4.2.3 DEFCLAS 

The DEFCLAS comnand defines the Input Classification file. The user can use 
this command to define a Classification file on tape or disk. The DEFCLAS 
command has the following forms and is invoked by typing one of the follow- 
ing, according to the user's requirement. 

If the file is on tape - 

DEFCLAS TAPE# FILE# <TAPE DENSITY> 

If the file is on disk - 

DEFCLAS FILENAME FILETYPE FILEMODE 

This command remains in effect for the use of any of the BADHWAR SYSTEM 
PROGRAM commands and dees not have to be reissued unless the user wishes to 
redefine the input Classification File. 


4.2.4 PARCLS 

The PARCLS comnand is a PROGRAti ccMmand and is used to invoke the execution 
of the PARCLS program. This command must not be used unless the OEFCLAS and 
the DEFGTRU FUNCTION commands have been previously issued. Also, as pre- 
viously stated the user must have established a SYMBOL FILE and a CARD CONTROL 
FILE on his A disk before invoking this command. The PARCLS command is 
invoked by the user typing the following: 

PARCLS < SYMBOL > < SYMBOL > <C0NTR0L CARD> < OUTPUT > < OUTPUT > ~ 

<FILENAME> <FILETYPE> < FILENAME > <FILENAME> <FILETYPE> 


The OUTPUT file is written on the user A disk under the user defined name 
and the REPORT file from the PARCLS program is spooled to the HOUSTON line 
printer. 
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4.2.5 END 


This connand closes the user's console file and causes a spooled copy to be 
sent to the HOUSTON printer. This command has no effect if the START command 
was not previously issued. The END command is invoked by the user typing the 
following: 

END 
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4.3 OPERATING EXAMPLE 


For our example we will assume the following: 


The symbol file is established on the user's A disk under the file description 
PARCLSl DATA A “ 


The control card file is established on the user's A disk under the file 
description: PARCLSl CC A 


Furthermore, the user has elected to use a ground truth file at LARS. 


COMMAND EXPLANATION OR ACTION TAKEN 

START Spools the console file. 

DEFGTRU 382 79 Defines a ground truth file using data from 

the LARS Data Base. 

DEFCLAS 0882 COEFOl S Defines a Class file on the user's'B disk. 

This data is on a disk which the user has 
previously attached to his disk using a B 
mode. 

P4RCLS PARPLTl DATA PARPLTl 0882 PARCOEF 

Executes the PARCLS PROGRAM. 

END Closes the user's console file and spools the 

files to the HOUSTON printer. 
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APPENDIX A 


COMMON BLOCK 



1 


COMMON BLOCKS 

/NSBIXL/ NSUBPXC6) 

NSUBPX Six subpixels that map to a pixel. 

/DEFGT/ GTRSEG, TYR, GTDATE(3) 

GTRSEG Ground truth segment number 

TYR Year of ground truth file creation. 

GTDATE Julian date of ground truth file creation. 

/DEFKL/ KLASEG, KYR, KLDATEC3) 

KLASEG Classification segment number. 

KYR Year of classification file creation. 

KLDATE Julian date of classification creation. 

/HEAD/ RCR0P(4,3), NCROP 
RCROP Crop names . 

NCROP Number of crop categories. 
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